Add Quick Settings tiles snippets - #1087

Code snippets are for: Quick Settings tiles

Three Kotlin blocks, into views/src/main/java/com/example/example/snippet/views/quicksettings/QuickSettingsTilesSnippets.kt.

spotlessApply changed indentation from two spaces to four and added a space in class MyQSTileService : TileService(). No line counts changed.

List of modifications

Two blocks on the page do not compile, and each needed one line changed.

Update your tile sets the content description from tile.label, and the Kotlin block declares no tile. Every other line in the block uses qsTile. The Java block on the same page declares Tile tile = getQsTile() and then uses tile, so the Kotlin block reads like a translation that lost the local variable and kept one use of it. Building the published lines gives Unresolved reference 'tile'.

The snippet reads state.label, which is the value assigned to qsTile.label one line earlier, so every right-hand side in the block comes from the model the block declares.

The page can be repaired either way: give the Kotlin block the Tile tile = getQsTile() line its Java sibling already has, or read from state as this snippet does.

Handle taps declares var clicks = 0 and then increments counter four times. Building the published lines gives four Unresolved reference 'counter' errors. The snippet names the declaration counter, which changes one line instead of four. Naming the four uses clicks is equally correct — please use whichever name reads better on the page.

Both blocks need a page edit either way. A reader who copies them today gets a compile error.

How the file is arranged

StateModel sits inside UpdateTileService rather than at the top level. The page shows the data class, a blank line, then the override; two spans of one region tag cannot keep that blank line, and the published snippet would come out a line shorter. One span keeps it. The nesting does not change what the page shows.

getStateFromService() is outside the region tags. The page calls it in both the Kotlin and the Java block and never defines it, so it reads as an app function rather than a platform API. The stub is here only so the module compiles.

The three regions live in three subclasses of TileService, not one. The first block overrides onStartListening() and onClick(), the second overrides onStartListening(), the third overrides onClick(). The second and third cannot share the first class.

Snippets not migrated

No other block on the page carries a region tag. Line numbers are from quicksettings-tiles.md.txt.

Keep the block at line 513: it shows the signature of requestAddTileService() and is reference text, not an example a reader copies.

The block at line 420 adds Intent.FLAG_ACTIVITY_NEW_TASK. It sits in the prose rather than under a Kotlin or Java heading, so it reads as an example for both languages, but it carries a semicolon, which makes it Java as written. Removing the semicolon makes it Kotlin and it stays correct for a Java reader. That is a page decision, so nothing here changes it.

The four XML manifest examples are not Kotlin and this change does not extract them. The one at line 140 has a defect worth fixing while the page is open:

android:label="@string/my_default_tile_label"  // 18-character limit.

XML has no // comment, so the example does not parse as printed and a reader who copies it gets a manifest that does not build. Moving the note above the element as <!-- 18-character limit. --> keeps the note and makes the example build. It has no effect on the snippets.